package org.ruoyi.knowledge.service;

public interface IDifyKnowledgeService {

    /**
     * 根据查询问题从 Dify 知识库检索答案（简单封装）。
     * @param datasetId 知识库 ID
     * @param query 查询文本
     * @param topK 返回结果条数（可选，可为 null）
     * @return Dify 原始响应字符串（JSON）
     */
    String retrieve(String datasetId, String query, Integer topK);

    /**
     * 分页获取 Dify 知识库列表
     * @param page 第几页（从1开始）
     * @param pageSize 每页数量
     * @return Dify 原始响应字符串（JSON）
     */
    String listDatasets(Integer page, Integer pageSize);

    /**
     * 分页获取某知识库下的文档列表
     * @param datasetId 知识库ID
     * @param page 第几页（从1开始）
     * @param pageSize 每页数量
     * @return Dify 原始响应字符串（JSON）
     */
    String listDocuments(String datasetId, Integer page, Integer pageSize);
}


